home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / util / libs / type1beta5.readme < prev   
Encoding:
Text File  |  1995-02-13  |  14.2 KB  |  305 lines
  1. Short:    Type1library - postscript font engine
  2. Author:   asd2@midway.uchicago.edu (Amish S. Dave)
  3. Uploader: asd2@midway.uchicago.edu
  4. Type:     util/libs
  5.  
  6. Postscript Type1 fonts on the Amiga - (at last!)
  7.  
  8. type1.library
  9. t1manager
  10.  
  11. by Amish S. Dave
  12. internet email: asd2@midway.uchicago.edu
  13.  
  14.  
  15. WARNING: This is still what I would call 'beta' software!
  16. Be wary!  There are known problems/incompatibilities!!
  17. I will not be held responsible for any problems, etc.
  18.  
  19.  
  20. ###########################################################################
  21.  
  22. INTRODUCTION
  23.  
  24. The files in this distribution implement a Postscript Type1 font
  25. engine for the Amiga.  It is designed as a shared library that
  26. does for type1 fonts what 'bullet.library' does for compugraphic
  27. fonts.  In addition, a program 't1manager' is included, which is
  28. required to install, remove, and preview type1 fonts.
  29.  
  30. NOTE: t1manager REQUIRES MUI.  I think that it will work with
  31. any version of MUI from 1.2 to 2.2.  I'm quite sure that it will
  32. work with MUI 2.0 onwards.
  33.  
  34. NOTE: both programs require AmigaDOS 2.1 or higher.  I honestly
  35. am not perfectly sure anymore about 2.0 (or 2.1).  I'll say that
  36. if your system supports Compugraphic fonts, then I think
  37. type1.library and t1manager should work.
  38.  
  39.  
  40. ###########################################################################
  41. INSTALLATION and USAGE
  42.  
  43. First of all, there are two versions of the library - one compiled for
  44. 68000 and no math coprocessor (which should run on any Amiga), and
  45. one compiled for 030 AND 68882 math coprocessor.  Pick the one you
  46. intend to use.
  47.  
  48. To install, do the following from the shell, or the equivalent from WB.
  49.  
  50.     CD <this directory>
  51.     COPY libs/type1.library.0x0 libs:type1.library       ; 000 or 030
  52.     COPY t1manager/t1manager sys:system                  ; or wherever
  53.     COPY t1manager/t1manager.info sys:system         ; copy icon
  54.  
  55. Now, you should be ready to install postscript fonts.  Do this by
  56. running the 't1manager' program.  
  57.  
  58. What I do, is I have a drawer called Apps:type1fonts, which
  59. is part of my FONTS: assign.  I accomplish this by having the
  60. following line in my user-startup file:
  61.  
  62.     ASSIGN fonts: apps:type1fonts ADD                    ; Note the ADD
  63.  
  64. Now, when you run t1manager, you can select the font drawer
  65. to use.
  66.  
  67. You install a font or fonts by clicking on install and selecting
  68. the font or fonts to install.  These must be binary type1 postscript
  69. files. They commonly end in '.pfb'.  There are several programs on
  70. Aminet that I've seen that will convert different postscript font
  71. formats to .pfb format.  Find one, if your favorite font doesn't
  72. install.
  73.  
  74. IMPORTANT!!!  The installer does NOT actually copy the binary file
  75. into the fontdrawer!!!  (unlike Intellifont/Fountain).  It creates
  76. the .font and .otag files (and an empty directory) in this drawer.
  77. The actual binary file must not be deleted, or moved, or else the
  78. font will stop working.  The .otag file simply refers to the font
  79. whereever it is.  Thus, if you have some postscript fonts as part
  80. of some application, say Pagestream, you don't have to have two
  81. copies - type1.library will read the font directly from the
  82. directory it was in when you installed the font.
  83.  
  84. To see a preview of an installed font, just double click on the font's
  85. name.  The preview will appear on the bottom panel.
  86.  
  87. Etc.
  88.  
  89. At this point, barring bugs, you should be able to select postscript
  90. fonts wherever you would otherwise select compugraphic fonts.
  91.  
  92. BETA: Note, however, that as of this beta version, there are still
  93. some substantial incompatibilities... Be forewarned.
  94.  
  95.  
  96.  
  97. ###########################################################################
  98. ###########################################################################
  99. WARNINGS/DISCLAIMERS/COPYRIGHT STUFF
  100. ###########################################################################
  101. I don't have the time or desire to understand any of the legal
  102. mumbo jumbo that's supposed to go here.  So what I'll put here
  103. will be in plain english and not legalese:
  104.  
  105. First of all: you can't sell this for money - note carefully
  106. the 'without fee' clause in the following blurb.  Insofar as
  107. the notice below permits, I think that the interpretation
  108. should be that Fred Fish-type prices for distribution are
  109. okay; selling this software by itself, or as part of a package
  110. where this software is part of the advertisement, is not okay.
  111.  
  112. Also: I disclaim any responsibility for anything regarding
  113. type1.library, t1manager, or any associated files, usage, etc.
  114. In other words, if anything goes wrong, it's not my fault.  In
  115. fact, I'll just say that it is likely that things will go wrong
  116. - if you choose to use or look at this software, be forewarned,
  117. and don't blame me!!
  118.  
  119. Furthermore, I don't claim too much credit for the software here:
  120. I just used, copied, modified and am now distributing software
  121. that was donated to the X Consortium by others.  The underlying
  122. font engine was written apparently for use with X-windows servers-
  123. I didn't write it, and don't claim exceptional knowledge about it.
  124. Here's the blurb that I think I'm obligated to add here:
  125.  
  126. /* Copyright International Business Machines, Corp. 1991
  127.  * All Rights Reserved
  128.  * Copyright Lexmark International, Inc. 1991
  129.  * All Rights Reserved
  130.  * Portions Copyright (c) 1990 Adobe Systems Incorporated.
  131.  * All Rights Reserved
  132.  *
  133.  * License to use, copy, modify, and distribute this software and its
  134.  * documentation for any purpose and without fee is hereby granted,
  135.  * provided that the above copyright notice appear in all copies and that
  136.  * both that copyright notice and this permission notice appear in
  137.  * supporting documentation, and that the name of IBM or Lexmark or Adobe
  138.  * not be used in advertising or publicity pertaining to distribution of
  139.  * the software without specific, written prior permission.
  140.  *
  141.  * IBM, LEXMARK, AND ADOBE PROVIDE THIS SOFTWARE "AS IS", WITHOUT ANY
  142.  * WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT
  143.  * LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
  144.  * PARTICULAR PURPOSE, AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.  THE
  145.  * ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE, INCLUDING
  146.  * ANY DUTY TO SUPPORT OR MAINTAIN, BELONGS TO THE LICENSEE.  SHOULD ANY
  147.  * PORTION OF THE SOFTWARE PROVE DEFECTIVE, THE LICENSEE (NOT IBM,
  148.  * LEXMARK, OR ADOBE) ASSUMES THE ENTIRE COST OF ALL SERVICING, REPAIR AND
  149.  * CORRECTION.  IN NO EVENT SHALL IBM, LEXMARK, OR ADOBE BE LIABLE FOR ANY
  150.  * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
  151.  * RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
  152.  * CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  153.  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  154.  */
  155.  
  156. The above applies only to portions of the code that contain the message
  157. at the top of the source.  Other source files (of which *some* begin with
  158. my first name; hey, what can I say :->  some people choose to use foo
  159. and bar - I use my first name!) were written by me, and probably contain
  160. Amiga-specific code. For these files, the same license to use, copy, etc.
  161. and the same proviso regarding warranties applies, with AMISH S. DAVE
  162. substituting for IBM, LEXMARK, and ADOBE.
  163.  
  164. Also, I used some enhancements to the X windows code provided by HP:
  165.  
  166. THE HP XLFD ENHANCEMENTS ARE PROVIDED "AS IS", WITHOUT ANY WARRANTIES OF
  167. ANY KIND, EITHER EXPRESS OR IMPLIED.  IN NO EVENT SHALL HEWLETT-PACKARD
  168. BE LIABLE FOR ANY SPECIAL, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY
  169. DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
  170. IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
  171. OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THESE
  172. ENHANCEMENTS.
  173.  
  174. ###########################################################################
  175.  
  176. WHERE DID IT COME FROM?
  177.  
  178. I started with the postscript rasterizer in the contrib distribution
  179. of X11R5 (X-Windows).  I have since used the X11R6 type1 font rasterizer,
  180. which is part of its core distribution.  I have also used some patches
  181. by HP that were on the ftp.x.org ftp site in the contrib section.
  182.  
  183. What I did was adapt it to look like the Amiga's compugraphic
  184. font engine (bullet.library).  My only source of information on
  185. writing such libraries was from the includes and by looking at
  186. what was being passed to and from bullet.library when diskfont
  187. called it (by SetPatch()-ing bullet.library).
  188.  
  189. After adapting the code to the Amiga, I sped it up, by re-writing some
  190. portions of the code, tweaking other portions, etc.  In some cases, I
  191. wrote assembly routines to replace C code.  These were my first 680x0
  192. assembly routines...
  193.  
  194. Then I whipped up a MUI utility to install/remove/preview fonts.  This
  195. was also my first MUI program.
  196.  
  197. ###########################################################################
  198.  
  199. WHERE IS IT GOING
  200.  
  201. I haven't had the time to work on this 'pet project' for a while. I
  202. don't anticipate finding the time in the near future.  Thus, I'm
  203. releasing now so as to encourage further development by others.  I
  204. personally consider this software to be at a 'beta' level - it certainly
  205. isn't polished enough yet for a 1.0 release, I think.
  206.  
  207. Hopefully, people will start working on this now.  I ask that people
  208. who work on this to please make public, or send me any updates or
  209. changes they make.  My intention is for there to only be a single
  210. type1.library for the Amiga, not a confusing litany of 14.15XYZ,
  211. 1.0K00L, ABC2.0 versions, each somewhat different...  That would suck.
  212.  
  213. ###########################################################################
  214.  
  215. KNOWN PROBLEMS
  216.  
  217. Most of the problems remaining stem from my not correctly supporting
  218. the glm_Width field of the glyphmap structure that I return.  Right
  219. now I put 1.0 for every character.  Also, there are many tags that I
  220. don't support yet.  The TODO file accompanying this release lists a
  221. few of the more important changes that need to be made.
  222.  
  223. ###########################################################################
  224.  
  225. THANKS TO:
  226.  
  227. Gregory Block - for code fragments, encouragement, insistance, harrassment
  228. (:->) and bug reports.
  229.  
  230. ###########################################################################
  231.  
  232.  
  233.  
  234. --
  235. Amish S. Dave                                    University of Chicago
  236. asd2@midway.uchicago.edu                         Biology Grad. Student
  237.  
  238.  
  239. ============================= Archive contents =============================
  240.  
  241. Original  Packed Ratio    Date     Time    Name
  242. -------- ------- ----- --------- --------  -------------
  243.    11050    4842 56.1% 10-Jan-95 08:41:48  type1/HISTORY
  244.     1437     599 58.3% 10-Jan-95 08:46:00  type1/HISTORY.info
  245.    10331    4443 56.9% 14-Jan-95 22:15:34  type1/README_Beta
  246.     1081     500 53.7% 14-Jan-95 22:02:04  type1/TODO
  247.      727     415 42.9% 10-Jan-95 08:46:00  type1/libs.info
  248.    76460   40538 46.9% 08-Jan-95 06:18:58  type1/libs/type1.library.000
  249.    67772   35876 47.0% 08-Jan-95 06:43:02  type1/libs/type1.library.030
  250.     1437     594 58.6% 10-Jan-95 08:46:00  type1/README_Beta.info
  251.      727     415 42.9% 10-Jan-95 08:46:00  type1/src.info
  252.      360     207 42.5% 17-Dec-94 05:33:34  type1/src/amishfontrequest.h
  253.     2488     997 59.9% 17-Dec-94 05:33:32  type1/src/amishio.c
  254.     2545     833 67.2% 17-Dec-94 05:33:32  type1/src/amishmalloc.c
  255.     1108     571 48.4% 17-Dec-94 05:33:34  type1/src/amisht1eexec.a
  256.    11443    3379 70.4% 08-Jan-95 06:04:46  type1/src/amisht1funcs.c
  257.     6552    3018 53.9% 17-Dec-94 05:33:32  type1/src/arith.c
  258.     7877    3058 61.1% 17-Dec-94 05:33:34  type1/src/curves.c
  259.     3457    1178 65.9% 17-Dec-94 05:33:34  type1/src/digit.h
  260.     1084     563 48.0% 17-Dec-94 05:33:34  type1/src/fillrun.a
  261.    11168    3609 67.6% 08-Jan-95 06:01:00  type1/src/fontfcn.c
  262.     4544    1272 72.0% 17-Dec-94 05:33:34  type1/src/fontfilest.h
  263.    52220   16110 69.1% 17-Dec-94 05:33:38  type1/src/global.h
  264.     1077     558 48.1% 17-Dec-94 05:33:34  type1/src/globals.c
  265.     5508    1429 74.0% 17-Dec-94 05:33:34  type1/src/hdigit.h
  266.    26823    9023 66.3% 17-Dec-94 05:33:34  type1/src/hints.c
  267.     4750    2199 53.7% 17-Dec-94 05:33:34  type1/src/lines.c
  268.     7159    2246 68.6% 17-Dec-94 05:33:36  type1/src/myfontstruct.h
  269.    39059   12213 68.7% 17-Dec-94 05:33:36  type1/src/paths.c
  270.     3309    1296 60.8% 17-Dec-94 05:33:36  type1/src/readfont.c
  271.    46688   15993 65.7% 17-Dec-94 05:33:32  type1/src/regions.c
  272.    41946   10268 75.5% 08-Jan-95 03:39:10  type1/src/scanfont.c
  273.     2297    1123 51.1% 08-Jan-95 06:19:20  type1/src/smakefile
  274.    27070    9284 65.7% 08-Jan-95 05:45:58  type1/src/spaces.c
  275.       34      34  0.0% 17-Dec-94 05:33:36  type1/src/t1gst.c
  276.    24722    8580 65.2% 17-Dec-94 05:33:34  type1/src/t1objects.c
  277.     2481    1310 47.1% 17-Dec-94 05:33:36  type1/src/t1snap.c
  278.    27169    7445 72.5% 08-Jan-95 03:18:48  type1/src/token.c
  279.    30443    3897 87.1% 17-Dec-94 05:33:32  type1/src/tokst.h
  280.    58536   16298 72.1% 08-Jan-95 06:10:42  type1/src/type1.c
  281.      223     129 42.1% 17-Dec-94 05:33:32  type1/src/type1_lib.fd
  282.      244     120 50.8% 17-Dec-94 05:33:32  type1/src/type1_pragmas.h
  283.     2366     971 58.9% 07-Jan-95 22:04:26  type1/src/type1interface.c
  284.     6184    1696 72.5% 07-Jan-95 22:20:54  type1/src/type1lib.c
  285.     4004    1618 59.5% 17-Dec-94 05:33:32  type1/src/util.c
  286.      727     418 42.5% 10-Jan-95 08:46:00  type1/t1manager.info
  287.     4029     761 81.1% 17-Dec-94 05:35:14  type1/t1manager/myimagegclass.h
  288.     2968    1918 35.3% 27-Feb-94 18:46:24  type1/t1manager/myimagegclass.o
  289.      964     479 50.3% 17-Dec-94 05:35:14  type1/t1manager/ReadMe.mui
  290.     1415     390 72.4% 10-Jan-95 08:44:20  type1/t1manager/ReadMe.mui.info
  291.     1013     507 49.9% 10-Jan-95 08:36:50  type1/t1manager/smakefile
  292.     1013     507 49.9% 10-Jan-95 08:14:14  type1/t1manager/smakefile.bak
  293.    13672    7911 42.1% 10-Jan-95 08:38:46  type1/t1manager/t1manager
  294.    16426    4898 70.1% 10-Jan-95 08:32:44  type1/t1manager/t1manager.c
  295.     3131     967 69.1% 17-Dec-94 05:35:14  type1/t1manager/t1manager.h
  296.     1571     991 36.9% 10-Jan-95 08:44:20  type1/t1manager/t1manager.info
  297.    20856    6560 68.5% 10-Jan-95 08:23:36  type1/t1manager/t1manager_backend.c
  298.       45      45  0.0% 17-Dec-94 05:35:14  type1/t1manager/t1managergst.c
  299.      244     120 50.8% 17-Dec-94 05:35:14  type1/t1manager/type1_lib.h
  300.      491     142 71.0% 17-Dec-94 05:35:14  type1/t1manager/type1_protos.h
  301.     1437     599 58.3% 10-Jan-95 08:46:00  type1/TODO.info
  302.      727     419 42.3% 10-Jan-95 08:47:58  type1.info
  303. -------- ------- ----- --------- --------
  304.   708689  258379 63.5% 16-Jan-95 11:37:32   60 files
  305.